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Preface 


This manual is for use by the system manager responsible for installing 
DATATRIEVE-11 Version 2.0 on the following systems: 


IAS V3.0 (with ““T” kit installed) 
RSX-11M V3.2 
RSX-11M-PLUS V1.0 

RSTS/E V7.0 

VMS V2.0 


oe eS ee ee 


CHAPTER 1 explains general installation procedures and customization of 
DATATRIEVE-11. 


CHAPTER 2 describes installation procedures for DATATRIEVE-11 on an 
IAS system. 


CHAPTER 3 describes installation procedures for DATATRIEVE-11 on 
RSX-11M and RSX-11M+ systems. 


Tet yr 


CHAPTER 4 describes installation procedures for DATATRIEVE-1i on a 


RSTS/E system. 


CHAPTER 5 describes installation procedures for DATATRIEVE-11 on a 
VMS system. 


APPENDIX A contains the acceptance test dialogue. 
Documentation Conventions 


The following conventions are used throughout this manual to show the 
DATATRIEVE installation procedures: 


The symbol represents the nonprinting carriage re- 
turn key. 


lowercase Lowercase text indicates variable information you pro- 
vide. 


UPPERCASE Uppercase text indicates literal information you enter as 
shown. 


color Information you type during the installation procedure is 
indicated in red. 


The circumflex () represents a control character. Thus, 
means the same thing as_ Z. 


Chapter 1 
General Information 


1.1 General Installation Procedures 
The installation procedure for DATATRIEVE is essentially the samé for all 


operating systems. In all cases, you must use a privileged account to access 


VP Vs Mss wee SS <-~“porr SY Re! i! ee BT 


needed seetein directories. The peneral installation procedure follows: 
Log in to a privileged account. 


Physically mount the distribution medium. 


oe. ee ES 


Copy the installation tape or disk cartridge. 


4. If you decide to customize DATATRIEVE, as outlined in Section 1.2, edit 


the file QD.MAC. 


5. Execute the DATATRIEVE-11 installation command file, or, on 
RSTS/E, execute the BUILD program. Executing this file installs 
DATATRIEVE-11 V2.0 and executes the DATATRIEVE Hecepance Test 
on all systems except RSTS/E. 


6. If the DATATRIEVE Acceptance Test was not executed as part of the 
build procedure, invoke DATATRIEVE and execute the command file 
DTR.TST. 


1.2 DATATRIEVE Customization 


Some DATATRIEVE options can be set at installation time. If you wish to 
change any options from the default, you must edit the file QD.MAC before 
execution of the DATATRIEVE installation command file. The options are: 


1. The name (and location) of the DATATRIEVE Data Dictionary. On 
all systems except RSTS/E the default file specification is 
LB:[1,2IQUERY.DIC. On RSTS/E the default file specification is 
LB:QUERY.DIC. If you want to move the dictionary to some other device 
or account, replace LB:[1,2}QUERY.DIC with the file specification that 
you want to use. If you do not want to have a central dictionary, change 
the dictionary file specification to SY:QUERY.DIC, and DATATRIEVE 
will look in each user’s directory for a dictionary. 
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10. 


The name and location of the DATATRIEVE message file. On all systems 
except RSTS/E the default file specification is LB:[1,2}QUERY.MSG. On 
RSTS/E the default file specification is LB:QUERY.MSG. If you want to 
move the message file to some other device or account, change the mes- 
sage file specification. The message file specification is referenced both 
by QDICT (which creates the message file at installation time) and 
DATATRIEVE itself. 


The action DATATRIEVE takes when it reads a shorter-than-expected 
RMS record. As a default, DATATRIEVE sends a warning message to the 
user’s terminal. The other option is that no warning message be sent. 


The default form for dates. As a default, dates will be interpreted as 
month / day. The other option is to interpret the date as day / month. 


Whether line-printer spooling is to be enabled (RSX-11M only). As a 
default, all output references to LP: are spooled. The other option is to 
have DATATRIEVE send output to LP: directly. 


The action to be taken for division by zero. As a default, DATATRIEVE 
sends a warning message and returns -1 as a value. The other option is to 
have DATATRIEVE return the value 0 with no warning message. 


The default terminal type for Guide mode. As a default, DATATRIEVE 
determines the terminal type at run time. The other options are to assume 
that all terminals are VT52’s or that all terminals are VT'100’s. 


Whether ADT is enabled or not. The default is that ADT is enabled. 


The default protection for dictionary objects. DATATRIEVE Version 1.1 
generated a protection code giving all privileges only to the creator. of a 
dictionary object. In Version 2.0, however, there are three available op- 
tions: (1) all privileges are given to the creator’s group (default), (2) all 
privileges are given only to the creator (as in Version 1.1), or (3) all privi- 
leges are given to all users of DATATRIEVE. 


The default for columns per page. The default value is 80. To change this, 
edit the line COLPAG == 80. 


Instructions for setting each option are in QD.MAC. 


General Information 


Chapter 2 
IAS V3.0 Installation Procedures 


You need the software and hardware listed in Sections 2.1.1 and 2.1.2 to 
install DATATRIEVE-11 V2.0. 

2.1.1 Software Requirements 

Before you can install DATATRIEVE-11, your computer must have: 

e TAS Version 3.0 with “T” kit 

e RMS-11K Version 1.8 (for RMS iidexed Record I/O) 


If your system does not have RMS-11K software, you must install it before 
installing DATATRIEVE-11. Get the kit with the RMS-11K software, and 
use the RMS-11 Installation Guide to install it. 


2.1.2 Hardware Requirements 


You need the following system configuration to install DATATRIEVE-11 
V2.0: 


CPU PDP-11 with EIS hardware 
MEMORY 64K bytes above the minimum operating system requirements 
TERMINAL A supported terminal (hard copy terminal preferred) 


TAPE One 9-track magnetic tape drive 
or 
DISK RK05, RKO06, RKO7, RLO1, or RLO2 drive 


DISK SPACE 2300 free blocks available in the target account 


2.2 Procedures for Installing DATATRIEVE-11 on IAS V3 
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The installation procedure has the following steps, which are described in 
detail in Sections 2.2.1 through 2.2.5: 


Log in to a privileged account of the form [1,x]. 
Mount the distribution medium. 

Copy the distribution files into your account. 
Dismount the distribution medium. 


Edit files, if necessary. 


Execute the command file DTRIAS. 


Se Hee Sh. aes SEE he UE 


Log off the system. 


2.2.1 Mount the Distribution Medium 

Physically mount the distribution medium onto a free tape or disk drive. 
For magnetic tape distribution, type the command: 

MOUNT/FOR/NOOP dev: DTRil 

For disk cartridge distribution, type the command: 

MOUNT/NOOP dev: DTRil 


The argument dev: stands for the device specification of the drive containing 
the distribution medium. 


2.2.2 Copy the Distribution Files 


To copy the data on a magnetic tape into the target account, type the 
command: 


COPY deurCi+tl¥#.#/DOS *.* ®E 


To copy the data on a disk cartridge into the target account, type the 
command: 
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2.2.3 Dismount the Distribution Medium 


To logically dismount the distribution medium, type the command: 
DISMOUNT dew: er 


When your terminal displays the DISMOUNT COMPLETE message, remove 
the distribution magnetic tape or disk cartridge, and store it in a safe place. 
The installation dialogue to this point for magnetic tape distribution is shown 
in the following example. The dialogue for disk distribution is similar. 


PDS? MOUNT/FOR/NOOP MMi: DTR1i1 
MOUNT-*#*VOLUME INFORMATION#+# 


DEVICE =MM1 

CLASS =FOREIGN 

UIC =Cle1] 

ACCESS =[RWED+RWED »RWED +»sRWEDI 
CHARAC ={FOR +ATCH+DCF] 


PDS? COPY MMi:Ci+il]#.*/DOS *.+* 


POS> DISMOUNT MMi: 


oe ee te 


DMO -- MMi: *#* DISMOUNT COMPLETE *+# 


PDS> 


2.2.4 Edit Files, if Necessary 


istomize DATATRIEVE as outlir 


wn 


(4 


If you wish in Section 1.2 


to c1 ne 
file QD.MAC. Instructions for editing are in the file. 


2.2.5 Execute the Command File 


To execute the command file, type: 
@DTRIAS 


DTRIAS is the command file that installs DATATRIEVE-11 into your sys- 
tem. As your computer executes this file, a series of messages informs you that 
the query dictionary and message file are being created. The last part of this 
command file is the execution of the DATATRIEVE Acceptance Test, which 
verifies whether DATATRIEVE has been properly installed. Your terminal 
lists the DATATRIEVE Acceptance Test, including prompts for input. Follow 
the directions displayed at the terminal. A copy of the DATATRIEVE 
Acceptance Test is in Appendix A. 


2.3 DATATRIEVE-11 Files 


After DATATRIEVE-11 has been installed, the following files are in the indi- 
cated UICs. Note that the [SELF] designation represents your privileged 
account. Files marked with an asterisk may be deleted. 
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* 


[11,130] 
[11,130} 
(11,130) 
[11,130] 
[11,130] 
[11,130] 
[11,130] 
(11,1) 
[11,1] 
(11,1) 
[111,130] 
* [111,130] 
[111,130] 
[311,130] 
[SELF] 
[SELF] 

* (SELF) 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
(SELF) 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 
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File Name 


DTRLIB.OLB 
QUERY.DIC 

QUERY.MSG 
YACHT.DAT 


OWNER.DAT 


DTRIAS.LNK 
DTRIAS.ODL 
QCIAS.LNK 
QCIAS.ODL 
QEIAS.LNK 
QEIAS.ODL 
RMSIAS.ODL 
DTR.TSK 
QCPRS.TSK 
QDEXT.TSK 
DTR.MAP 
QCPRS.MAP 
QDEXT.MAP 
QD.MAC 
DTR.TST 
MSGS.SEQ 
QDIAS.LNK 
QDIAS.ODL 
QDICT.MAP 
QDICT.TSK 
YACHT.SEQ 
OWNER.SEQ 
FAMILY.DAT 
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Description 


DATATRIEVE object library 

Data dictionary 

Message file 

Acceptance test data file 

Acceptance test data file 

DATATRIEVE task-build command file 
DATATRIEVE overlay description file 
COMPRESS program task-build command file 
COMPRESS program overlay description file 
EXTEND program task-build command file 
EXTEND program overlay description file 
RMS overlay description file 

DATATRIEVE task image 

Dictionary COMPRESS program 

Dictionary EXTEND program 

DATATRIEVE map file 

Dictionary COMPRESS program map file 
Dictionary EXTEND program map file 
Dictionary filename source module 

Acceptance test command file 

Message file (distribution format) 

Dictionary build program task-build command file 
Dictionary build program overlay description file 
Dictionary build program map file 

Dictionary build program 

Acceptance test data file (distribution format) 
Acceptance test data file (distribution format) 


Acceptance test data file (distribution format) 
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RSX-11M V3.2 and RSX-11M-PLUS V1.0 
Installation Procedures 


3.1 System Requirements 
You need the software and hardware listed in Sections 3.1.1 and 3.1.2 to 
install DATATRIEVE-11 V2.0. 
3.1.1 Software Requirements 
Before you can install DATATRIEVE-11, your computer must have: 
1. RSX-11M Version 3.2 Mapped System 
2. RSX-11K Version 1.8 (for RMS Indexed Record I/O) 


If your system does not have RMS-11K software, you must install it before 
installing DATATRIEVE-11. Get the kit with the RMS-11K software, and 
use the RMS-11 Installation Guide to install this software. 


3.1.2 Hardware Requirements 


You need the following system configuration to install DATATRIEVE-11 
V2.0: 


CPU PDP-11 with EIS hardware 
MEMORY 64K bytes above the minimum operating system requirements 
TERMINAL A supported terminal (hard copy terminal preferred) 


TAPE One 9-track magnetic tape drive 
or 
DISK RK05, RKO06, RKO7, RLO1, or RLO2 drive 


DISK SPACE 2300 free blocks available in the target account 


3.2 Procedures for Installing DATATRIEVE-11 on RSX-11M V3 
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The installation procedure has the following steps, which are described in 
detail in Sections 3.2.1 through 3.2.7: 


Log in to a privileged account of the form [1,x]. 
Physically mount and allocate the distribution medium. 
Mount the distribution medium (except for magnetic tape on RSX-1iM). 


Copy the distribution medium into your account. 


GON 1 a Se UES 


Dismount the distribution medium (except when using magnetic tape on 


RSX-11M). 
6. Deallocate the distribution device. 
7. Edit files if necessary. 
8. Execute the command file DTR11M. 
9. Log off the system. 
3.2.1 Physically Mount and Allocate the Distribution Medium 
Physically mount the distribution medium onto a free tape or disk drive. 
Give the command: 


ALL deus: ET 


The argument dev: stands for the device specification of the drive containing 
the distribution medium. 


3.2.2 Logically Mount the Distribution Medium 


Mounting the distribution medium is necessary except when using a magnetic 
tape to install DATATRIEVE-11 on RSX-11M. 


For disk cartridge distribution, type the command: 
MOU dev: DTR1d 
For magnetic tape distribution on RSX-11M-PLUS, type the command: 


MOU deus /FOi 


—> 


REI 


é 


3.2.3 Copy the Distribution Files 


For disk cartridge distribution, copy the data into your account with the 
command: 


PIP S¥e/NVedeursCi+il]*,# 


RSX-11M V3.2 and RSX-11M-PLUS V1.0 Installation Procedures 


For magnetic tape distribution, copy the data into your account with the 
command: 


FLX S¥:/RSX=deur10Cil+ij*.*/D05 


3.2.4 Dismount the Distribution Medium (Except RSX-11M 
Magnetic Tape) 


To logically dismount the distribution medium, type the command: 


DMO deus ET 


When your terminal displays the DISMOUNT COMPLETE message, remove 
the distribution medium and store it in a safe place. 


3.2.5 Deallocate the Distribution Device 
Deallocate the distribution device by typing the command: 


DEA deus: ET 


The following example shows the installation dialogue to this point for disk 
distribution. The dialogue for magnetic tape distribution is similar. 


ALL DK1I: 


”, nei .~nTn 
>MOU DRI:OTR 


il 
PIP S¥:/NV=DKi:Cl+il*.* 
*>DMO DKi: 
*>DEA DK1I: 


3.2.6 Edit Files, if Necessary 


If you wish to customize DATATRIEVE as outlined in Section 1.2, edit the 
file QD.MAC. Instructions for editing are in the file. 


3.2.7 Execute the Command File 


To execute the command file, type: 


@DTR11M 


DTRI11M is the command file that installs DATATRIEVE-11 into your sys- 
tem. As your computer executes this command file, a series of messages 
informs you that the query dictionary and message file are being created. 
The last part of the command file is the execution of the DATATRIEVE 
Acceptance Test, which verifies whether DATATRIEVE has been installed 
properly. Your terminal displays the DATATRIEVE Acceptance Test as it 
executes, including prompts for input. Follow the directions displayed at the 
terminal. A copy of the DATATRIEVE Acceptance Test is in Appendix A. 
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3.3 DATATRIEVE-11 Files 


After DATATRIEVE-11 has been installed, the following files are in the indi- 
cated UICs. Note that the [SELF] designation represents your privileged 
account. Files marked with an asterisk can be deleted. 


VIC 


* [1,1] 
[1,2] 
(1,2) 
[1,2] 
[1,2] 
[1,2] 

* [1,24] 

* [1,24] 

* [1,24] 

* [1,24] 

* [1,24] 

* [1,24] 

* [1,24] 

* [1,34] 

* [1,34] 

* [1,34] 
[1,54] 
(1,54) 
(1,54) 

* [SELF] 

* (SELF) 

* [SELF] 

* [SELF] 

* [SELF] 

* [SELF] 

* (SELF) 

* (SELF) 

* (SELF) 


File Name 


DTRLIB.OLB 
QUERY.DIC 
QUERY.MSG 
YACHT.DAT 
OWNER.DAT 
FAMILY.DAT 
DTR11M.ODL 
DTR11M.TKB 
QC11M.ODL 
QC11M.TKB 
QE11M.0DL 
QE11M.TKB 
RMS11M.ODL 
DTR.MAP 
QCPRS.MAP 
QDEXT.MAP 
DTR.TSK 
QCPRS.TSK 
QDEXT.TSK 
DTR.TST 
MSGS.SEQ 
QD.MAC 
QD11M.0DL 
QD11M.TKB 
QDICT.MAP 
QDICT.TSK 
YACHT.SEQ 
OWNER.SEQ 


Description 


DATATRIEVE object library 

Data dictionary 

Message file 

Acceptance test data file 

Acceptance test data file 

Acceptance test data file 

DATATRIEVE overlay description file 
DATATRIEVE task-build command file 
COMPRESS program overlay description file 
COMPRESS program task-build command file 
EXTEND program overlay description file 
EXTEND program task-build command file 
RMS overlay description file 

DATATRIEVE map file 

Dictionary COMPRESS program map file 
Dictionary EXTEND program map file 
DATATRIEVE task image 

Dictionary COMPRESS program 

Dictionary EXTEND program 

Acceptance test command file 

Message file (distribution format) 

Dictionary filename source module 

Dictionary build program overlay description file 
Dictionary build program task-build command file 
Dictionary build program map file 

Dictionary build program 


53 
eth 
fo) 
Lae 3 
FF 
iY) 
et 
ee 


Accepiance test data file (distributio 


Acceptance test data file (distribution format) 
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Chapter 4 
RSTS/E Installation Procedures 


4.1 System Requirements 


You need the software and hardware listed in Sections 4.1.1 and 4.1.2 to 
install DATATRIEVE-11 V2.0. 


4.1.1 Software Requirements | 
You must have the following software to install DATATRIEVE-11: 


¢ RSTS/E Version 7.0 with Monitor RSX Emulation 

¢ RT11.RTS - The RT-11 Run-Time System 

e RSX.RTS - The RSX Run-Time System 

e SYSLIB.OLB - The RSX system object library 

e PIP.SAV - Peripheral Interchange program located in account LB: 
e TKB.TSK - The Task-builder in account LB: 

e MAC.TSK - The MACRO-11 assembler in account LB: 

e RMS11.RTS - The RMS-11 Run-Time System 

¢ RMS-11 Version 1.8 (for RMS indexed Record I/O) 


If your system does not have RMS-11 software, you must install it before 
installing DATATRIEVE-11. Get the kit with the RMS-11 software, and use 
the procedures presented in RMS-11 Installation Guide to install the 
software. 


4.1.2 Hardware Requirements 


You need the following system configuration to install DATATRIEVE-11 
V2.0: 


CPU PDP-11 with EIS hardware 
MEMORY 64K bytes above the minimum operating system requirements 
TERMINAL A supported terminal (hard copy terminal preferred) 


TAPE One 9-track magnetic tape drive 
or 
DISK RK05, RKO06, RKO7, RLO1, or RLO2 drive 


DISK SPACE 2300 free blocks available in the target account 


4.2 Procedures for Installing DATATRIEVE-11 on RSTS/E 


The installation procedure has the following steps, which are described in 
detail in Sections 4.2.1 through 4.2.5: 


Log in to a privileged account of the form [1,x]. 

Physically mount and logically assign the distribution medium. 
Copy the distribution medium into your account. 

Deallocate the distribution device. 

Edit files if necessary. 

Execute the BUILD program. 

Run the DATATRIEVE Acceptance Test. 


Oe es A? TE ee, vais 


Log off the system. 


4.2.1 Mount and Assign the Distribution Medium 
Physically mount the distribution medium onto a free tape or disk drive. 


For magnetic tap 
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ASSIGN devw:.D0S 


8 


For disk cartridge distribution, type the command: 


MOUNT dev:rDTRII/RONLY GED 


The argument dev: stands for the device specification of the drive containing 
the distribution medium. 
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4.2.2. Copy the Distribution Files 


Copy the data on the distribution medium into your account with the 
commands: 


RUN #PIP.SAYW 
Be ,e=deurlisi]*.+* 


Rea 
a 


At this time, data on the distribution medium is copied into your account. 
Your terminal displays the prompt READY when the copying operation is 
complete. 


4.2.3 Deassign the Distribution Device 


To logically deassign a magnetic tape, type the command: 


DEASSIGN deu: 


DISMOUNT dev:DTRil 


When your terminal displays the READY prompt, remove the distribution 
medium and store it in a safe place. The installation dialogue to this point for 


disk distribution is shown in the following example. The dialogue for magnetic 


tape distribution is similar. 


Ready 


MOUNT DKi:DTRIi/RONLY 


Ready 


RUN $PIP,SAY 
Be, e%¥=DKi:0Li+i]*.+* 


md 
be 
Ready 


DISMOUNT DK1: 


Ready 


4.2.4 Edit Files, if Necessary 


If you wish to customize DATATRIEVH, as outlined in Section 1.2, edit the 
file QD.MAC. Instructions for editing are in the file. 


4.2.5 Execute the BUILD Program 
To execute the BUILD program, type: 


RUN $BUILD 
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* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


PPN 


LB: 
LB: 
LB: 
LB: 
LB: 
LB: 
LB: 
LB: 
LB: 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
(SELF) 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 


File Name 


DTRLIB.OLB 
DTR.TSK 
QCPRS.TSK 
QDEXT.TSK 
QUERY.DIC 
QUERY.MSG 
YACHT.DAT 
OWNER.DAT 
FAMILY.DAT 
DTR.MAP 
DTR.TST 
DTRSTS.ODL 
DTRSTS.TKB 
MSGS.SEQ 
QCPRS.MAP 
QCRSTS.ODL 
QCRSTS.TKB 
QDEXT.MAP 
QDICT.MAP 
QDICT.TSK 
QD.MAC 
QDRSTS.ODL 
QDRSTS.TKB 
QERSTS.ODL 
QERSTS.TKB 
RMSRST.ODL 
YACHT.SEQ 
OWNER.SEQ 


Description 


DATATRIEVE object library 

DATATRIEVE task image 

Dictionary COMPRESS program 

Dictionary EXTEND program 

Data dictionary 

Message file 

Acceptance test data file 

Acceptance test data file 

Acceptance test data file 

DATATRIEVE map file 

Acceptance test command file 

DATATRIEVE overlay description file 
DATATRIEVE task-build command file 
Message file (distribution format) 

Dictionary COMPRESS program map file 
COMPRESS program overlay description file 
COMPRESS program task-build command file 
Dictionary EXTEND program map file 
Dictionary build program map file 

Dictionary build program 

Dictionary filename source module 

Dictionary build program overlay description file 
Dictionary build program task-build command file 
EXTEND program overlay description file 
EXTEND program task-build command file 
RMS overlay description file 

Acceptance test data file (distribution format) 


Acceptance test data file (distribution format) 
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Chapter 5 
VAX/VMS Installation Procedures 


5.1 System Requirements 


erate & 


VAX/VMS V2.0 contains the necessary hardware and software to install 
DATATRIEVE-11 Version 2.0. 


5.2 Procedures for Installing DATATRIEVE-11 on VMS V2.0 


The installation procedure has the following steps, which are described in 
detail in Sections 5.1.2 through 5.1.6: 


Log in to a privileged account of the form [1,x]. 
Assign logical names and defaults. 

Invoke the command procedure to start installation. 
Mount distribution media when asked to. 

Edit files if customizing DATATRIEVE. 

Enter data for DATATRIEVE Acceptance Test. 


Replace standard console medium. 


See ee er Se oe 


Logout. 


5.2.1 Assign Logical Names and Defaults 


1. Make sure that logical name SYS$DISK is assigned to the disk that con- 
tains the current version of VAX/VMS. This disk contains the command 
procedure that starts the new installation/update procedure. Note that 
SYS$DISK need not be (and if possible, should not be) SYS$SYSTEM. 


2. Assign logical name LB: to the device on which DATATRIEVE is to be 
built. For example: 


$ASSIGN DBB2: LB: 
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When you invoke DATATRIEVE, your computer uses the logical name 
LB: by default. Therefore, you must assign it to the device on which 
DATATRIEVE is being built. 


3. Set default UIC and default directory by typing: 
$SET UIC [i+4] 


$ SET DEFAULT LB: CSYSUPD] 


5.2.2 Start the Installation Procedure 


Type the command: 


$ @LB:CSYSUPDIVMSUPDATE 


The system’s command procedure (VMSUPDATE) prints the following mes- 
sage on the terminal: 


This command Procedure performs VAX/VMS software updates and unbundled 
software installations... 


During this sequence: the standard console medium will not be Present 
in the console drive. 


Therefore, the system is vulnerable to Power failure or other fatal 
crash. If a system crash should occur during this time the update 
Se9uence can be restarted at the beginning of the first incomplete 
uPdate, 

Dismount the current console medium, 

Please Place the first medium of the Kit in the console drive, 


If there is no medium mounted, you receive a device-not-mounted message, 
which should be ignored. 


5.2.3 Mount Distribution Media 


Remove the console medium. If you are using fliexibie diskettes, note the 
direction the console diskette is facing. Diskettes from the distribution kit 
must be inserted in the drive so they face the same direction. (The label is on 
the front side of the diskette.) Place the first medium in the drive, and answer 
Y to the query: 


ARE YOU READY TO CONTINUE? Y 
To install DATATRIEVE answer I to the query: 
Do you wish to install or Patch Datatrieve? I 


Continuation of the installation is indicated by the message: 


Fee eCOPying first mediumess 
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This phase of the installation is complete when you receive the message: 


Please Put the second Datatrieve Kit medium in the drive, 


Remove the first medium from the console drive and replace it with the 
second medium. Type Y in response to the query: 


sé 


Are you ready to continue? ‘ 


The following message indicates that the installation is continuing: 


Pees COP¥Iind second mediumess 


This phase of the installation is complete when you receive the message: 


Please put the third Datatrieve Kit medium in the drive, 


Are you ready to continue? *¥ 
The following message indicates that the installation is continuing: 


Fees tOPyingd third medium.:: 


5.2.4 Edit QD.MAC if Customizing DATATRIEVE 


If you wish to customize DATATRIEVE, then answer Y to the query: 


Vf 


Do you want to edit OD.MAC before installing Datatrieave? 3 


If you type in Y, the computer responds with the line: 


Enter command string without file-spec to invoke editor 


Type in the command string you normally use to invoke the text editor you 
want to use. Do not type in a file name, however, for the command file will 
invoke the editor with QD.MAC as the input file. When you finish editing 
QD.MAC, exit from your editor, and the installation procedure continues. 
The next query gives you another chance to edit QD.MAC: 


Do von Want to re-invuoke the editor? 


If you have made any mistakes in trying to invoke the editor, or in editing 
QD.MAC, respond with Y, and you can re-invoke the editor. 


The next series of messages tells you that the query dictionary and message 
file are being created. When this phase is complete, the DATATRIEVE 
Acceptance Test is run. 
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5.2.5 Enter Data for Acceptance Test 


Your terminal displays the DATATRIEVE Acceptance Test as it runs, includ- 
ing prompts for input. Follow the directions displayed at the terminal. The 
Acceptance Test verifies whether DATATRIEVE has been properly installed. 
A copy of the Acceptance Test is in Appendix A. 


Completion of this phase is signaled by the messages: 


bees Cleaning up CSYSUPD]... 
yee+Datatrieve installation/uPdate completed... 


5.2.6 Replace Standard 


Console Medium 


If you are not making any further updates, respond N to the query: 


ARE THERE ANY MORE KITS 


You should then restore the 


TO PROCESS? N 


standard console medium to the console drive. 


The console medium is mounted when you respond Y to the query: 


ARE YOU READY 


TO CONTINUE? Y 


Finally, after installing DATATRIEVE, you should back up the volume 
SYS$DISK and save the original for future updates. 


5.3 DATATRIEVE Files 


When DATATRIEVE-11 has been installed, the following files are in the 
indicated UICs. Note that the [SELF] designation represents your privileged 
account. Files marked with an asterisk may be deleted. 
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UIC File Name 

* (1) DTRLIB.OLB 
[1,2] DTR.EXE 
[1,2] QCPRS.EXE 
[1,2] QDEXT. EXE 
(1,2) QUERY.DIC 
[1,2] QUERY.MSG 
{1,2} YACHT.DAT 
[1,2] OWNER.DAT 
[1,2] FAMILY.DAT 

* [SELF] DTR.MAP 

* (SELF) DTR.TST 

* [SELF] DTRVAX.ODL 
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Description 


DATATRIEVE object library 
DATATRIEVE task image 
Dictionary COMPRESS program 
Dictionary EXTEND program 
Data dictionary 

Message file 

Acceptance test data file 
Acceptance test data file 
Acceptance test data file 
DATATRIEVE map file 
Acceptance test command file 
DATATRIEVE overlay description file 
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* 


* 


* 


* 


x 


Py 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


UIC 


[SELF] 
[SELF] 
(SELF) 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
[SELF] 
(SELF) 
[SELF] 


(SELF) 


[SELF] 
[SELF] 


File Name 


DTRVAX.TKB 
MSGS.SEQ 
QCPRS.MAP 
QCRVAX.ODL 
QCRVAX.TKB 
QDEXT.MAP 
QDICT.MAP 
QDICT.TSK 
QD.MAC 
QDVAX.ODL 
QDVAX.TKB 
QEVAX.ODL 
QEVAX.TKB 
RMSRSX.ODL 
YACHT.SEQ 
OWNER.SEQ 


Description 


DATATRIEVE task-build command file 

Message file (distribution format) 

Dictionary COMPRESS program map file 
COMPRESS program overlay description file 
COMPRESS program task-build command file 
Dictionary EXTEND program map file 

Dictionary build program map file 

Dictionary build program 

Dictionary filename source module 

Dictionary build program overlay description file 
Dictionary build program task-build command file 
EXTEND program overlay description file 
EXTEND program task-build com 


RMS overlay description file 
Acceptance test data file (distribution format) 


Acceptance test data file (distribution format) 
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Appendix A 
Acceptance Test 


i 
i CLEAN UP FROM POSSIBLE PREVIOUS RUNS OF TEST 
i 


DELETE FAMILIES} 


"FAMILIES" has not been defined in the dictionary 
"FAMILY-REC" has not been defined in the dictionary 
DELETE KETCHES: 
"KETCHES" has not been defined in the dictionary 
DELETE OWNERS-SEQUENTIAL: 
"OWNERS-SEQUENTIAL" has not been defined in the dictionary 
DELETE OWNERS: 
"OWNERS" has not been defined in the dictionary 
"OWNER-RECORD" has not been defined in the dictionary 
DELETE SAILBOATS: 
"SAILBOATS" has not been defined in the dictionary 
DELETE YACHTS-SEQUENTIAL: 
"¥YACHTS-SEQUENTIAL" has not been defined in the dictionary 
DELETE YACHTSS$ 
"YACHTS" has not been defined in the dictionary 
DELETE YACHT: 
"YACHT" has not been defined in the dictionary 
DELETE PRICE-PER-POUND 
"PRICE-~PER-POUND" has not been defined in the dictionary 
DELETE VERIFY 3 
"WERIFY" has not been defined in the dictionary 
DELETE LOA-REPORT: 
"LOA-REPORT" has not been defined in the dictionary 
DELETE RIG-TABLEs 
"RIG-TABLE" has not been defined in the dictionary 
' 
IDEFINE RECORD 
i 
DEFINE RECORD YACHT USING 
O1 BOAT. 
O3 TYPE. 
OG MANUFACTURER PIC XK(10) 
QUERY-NAME IS BUILDER. 
O06 MODEL PIC X(10) 
O3 SPECIFICATIONS 
QUERY-NAME SPECS, 
OG RIG PIC X(G) 
VALID IF RIG EQ "SLOOP";+"KETCH"+"MS";+"YAWL". 
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O06 LENGTH-OVER-ALL PIC XXx 
VALID IF LOA BETWEEN 15 AND 50 
QUERY-NAME IS LOA. 

06 DISPLACEMENT PIC 99999 
QUERY-HEADER IS "WEIGHT" 
EDIT-STRING IS 22:+229 
QUERY-NAME IS DISP,. 

06 BEAM PIC 99, 

OG PRICE PIC 99999 
YALID IF PRICE?DISP#1.3 OR PRICE EQ 0 
EDIT-STRING IS $$$,%¢% ,. 


CRecord YACHT is 41 brtes longl 

! 

1 DEFINE DOMAINS 

1 

DEFINE DOMAIN YACHTS-SEQUENTIAL USING YACHT ON YACHT.SEO ; 

DEFINE DOMAIN YACHTS USING YACHT ON YACHT.DAT: 

i 

! DEFINE THE ACTUAL FILE FOR YACHTS 

1 

DEFINE FILE YACHTS KEY=TYPEC(NO DUP) -KEY=MODEL(DUP;+>NO CHANGE); 
ALLOCATION=30, SUPERSEDE 

1 


| MAKE YACHTS ACCESSIBLE BY OTHERS 
i 


DEFINEP YACHTS 2;PW+"SHHHH" +H ! PASSWORD FOR WRITE 
DEFINEP YACHTS 3;UIC+C#+*1°R ! EVERYONE ELSE GETS READ 
DEFINEP YACHT 2:sUIC+C*¥+*1+R ' GIVE ACCESS TO RECORD DEFINITION: TOO 


SHOWP YACHTS 
1sUIC; C31i+*#]+> "RWMEC" 
2+3PW:+ "SHHHH">+ "W" 
3+UIC;+ C¥+¥];+ "KR" 
! 
|! DEFINE PROCEDURES 
t 
DEFINE PROCEDURE PRICE-PER-POUND 
PRICE*#1,00/BISP ("PRICE"/"PER"/"POUND") USING #$.99 
END-PROCEDURE 
DEFINEP PRICE-PER-POUND 2;-UIC+C¥+#]>RE 
I 
DEFINE PROCEDURE VERIFY 
VERIFY USING 
BEGIN 
PRINT 
DISPLAY "CONFIRM WITH Y IF OK" 
IF *.CONFIRM NOT CONTAINING "¥" THEN ABORT “UPDATE ABORTED" 
END 
END-PROCEDURE 
DEFINEP VERIFY 2;UIC;+;C¥+#]:+RE 
1 
i COPY DATA FROM SEQUENTIAL TO INDEXED FILE 
I 
READY YACHTS WRITE 
SHOW FIELDS 


YACHTS 
BOAT 
TYPE CIindexed field] 
MANUFACTURER (BUILDER) CCharacter string+ indexed Key] 
MODEL [Character string: indexed Key] 
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SPECIFICATIONS (SPECS) 
FIG (tCnaracter stringi 


LENGTH-OVER-ALL (LOA) CCharacter string] 
DISPLACEMENT (DISP)} CNumber] 

BEAM CNumber] 

PRICE CNumber] 


READY YACHTS-SEQUENTIAL 

SHOW READY 

Ready domains: 
YACHTS-SEQUENTIAL: RMS SEQUENTIAL: PROTECTED READ 
YACHTS: RMS INDEXED+s PROTECTED WRITE 

I 


FOR YACHTS-SEQUENTIAL STORE YACHTS USING BOAT=BOAT 
i 


FINISH YACHTS-SEQUENTIALS3 
! 


TEST STORE 


PLEASE SUPPLY THE FOLLOWING VALUES: 


i 

i 

! 

! MANUFACTURER: HINKLEY 

! MODEL: BERMUDA 40 
! RIG: YAWL 

} LENGTH-OVER-ALL: 1406 

: LENGTH-OVER-ALL: 46 

! DISPLACEMENT: 29000 

! BEAM: 12 

! PRICE: B2000 AND &KX/100 
! PRICE: B2000 

! CONFIRM: N 


STORE YACHTS : VERIFY 

Enter MANUFACTURER: HINKLEY 

Enter MODEL: BERMUDA 40 

Enter RIG: ‘YAWL 

Enter LENGSTH-OVER-ALL: 146 
Yalidation error for LENGTH-OQVER-ALL 
Re-enter LENGTH-OVER-ALL: 40 

Enter DISPLACEMENT: 20000 

Enter BEAM: 12 

Enter PRICE: 82000 AND XXK/100 
Non-digit in string "82000 AND KXX/100"5 ignoring character(s) 
Re-enter PRICE: 82,000 


LENGTH 

OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
HINKLEY BERMUDA 40 YAWL 40 20 +000 12 $82 +5000 


DISPLAY: CONFIRM WITH Y IF OK 

Enter CONFIRMATION:N 

ABORT: STORE ABORTED 

Execution terminated by "ABORT" statement 
{ 

! 

! CHANGE READY MODE FOR READ ACCESS 
! 

READY YACHTS 

FIND YACHTS WITH PRICE NE O 

[S52 records found] 
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SORT BY LOA+DESC DISPLACEMENT 


SHOW ALL 
Domains: 

YACHTS YACHTS-SEQUENTIAL 
Records: 

YACHT 


Procedures: 
PRICE-PER~-POUND 
Collections: 
CURRENT 
Ready domains: 
YACHTS: RMS INDEXED; PROTECTED READ 
SHOW CURRENT 
Collection CURRENT 
Domain: YACHTS 
Number of records: 50 
No selected record 
Sort order: LENGTH-OQVER-ALL »-DISPLACEMENT 


VERIFY 


PRINT ALL 
LENGTH 
OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
WHINDPOWER IMPULSE SLOOP 16 650 07 $3,500 
CAPE DORY TYPHOON SLOOP 19 1 +900 OG $4,295 
VENTURE 21 SLOOP 21 1500 07 $2;:823 
VENTURE 222 SLOOP 22 22000 07 $3,564 
EASTWARD HO M/S 24 7 +000 og $15 -900 
ISLANDER BAHAMA SLOOP 24 4+200 oB $6 +500 
IRWIN 25 SLOOP 25 5 +400 iZ $10,950 
CAPE DORY 23 SLOOP 25 4:000 o7 $8,995 
SALT ig SLOOP 25 2»600 07 $6,590 
WESTERLY CENTAUR SLOOP 26 6+700 08 $15 +245 
GRAMPIAN 26 SLOOP 26 3600 0B #11,495 
AMERICAN 2G6-MS M/S 26 5 +500 08 $18,895 
TANZER 26 SLOOP 26 4;350 og $11,750 
ALBIN 79 SLOOP 26 4+200 10 $17,900 
AMERICAN 26 SLOOP 26 4,000 08 $9,895 
HUNTER 27 SLOOP 27 6 +500 o>9 $14,999 
ALBIN VEGA SLOOP 27 5 +070 08 $18-600 
CAPE DORY 28 SLOOP 28 9,000 og $21;:990 
SABRE 2B SLOOP 28 7 +400 09 $22,000 
GRAMPIAN 28 SLOOP 28 6,900 10 $14,475 
TANZER 28 SLOOP 28 6 +800 10 $17;500 
TSLANDER 28 SLOOP 28 5994 10 $15,908 
NORTHERN 29 SLOOP 29 7+250 09 $270,975 
IRWIN 30 SLOOP 30 10:000 10 $19,-.950 
HUNTER 30 SLOOP 30 9,500 10 $21,500 
GRAMPIAN 30 SLOOP 30 8+G00 og $17+775 
ISLANDER 30 SLOOP 30 8,600 10 $20,990 
ALBIN BALLAD SLOOP 30 7 +276 10 $27,900 
RYDER S. CROSS SLOOP 31 13 +600 00 $32,500 
BOMBAY CLIPPER SLOOP 31 9 +400 ii $23,956 
WRIGHT SEAWIND II SLOOP 32 14,900 oO $34;480 
CHALLENGER 32 SLOOP 32 12:;800 . il $31;+835 
O’DAY 32 SLOOP 32 11000 00 $29 +500 
BAYFIELD 30/32 SLOOP 32 9,500 io $32,875 
(continued on next page) 
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GRAMPIAN 34 KETCH 33 12 +9000 19 $29 ;6735 


GRAMPTAN 2-34 SLOOP 34 11 +800 16 $29,675 
CARIBBEAN 35 SLOOP 395 18 +000 ii $37 +850 
CHRIS-CRAFT CARIBBEAN SLOOP 35 18 +000 11 $37 +850 
CHALLENGER 35 SLOOP 35 145800 Le $395,215 
I. TRADER 37 KETCH 36 18 +GO0O 12 $39 +500 
ISLANDER 36 SLOOP 36 13 +450 pe $315730 
ALBERG 37 MK II KETCH 3? 201000 12 $36 5951 
IRWIN 37 MARK II KETCH 3? 20 +000 11 $36 +950 
NORTHERN 37 KETCH ar 14;000 1 $50 +000 
LINDSEY 39 M/S 3g 1455900 12 $35 +900 
CHALLENGER 41 KETCH 41 26 +700 i3 $31+228 
GULFSTAR 4i KETCH 4i 22 +000 12 $415350 
ISLANDER FREEPORT KETCH 41 22 +000 11 $54 +970 
COLUMBIA 4i SLOOP 4i 294700 11 $48 +490 
OLYMPIC ADVENTURE KETCH 42 245250 13 $80 +500 


SELECT FIRST 


PRINT 

LENGTH 

OVER 

MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
WINDPOWER IMPULSE SLOOP 16 650 07 $3+500 
SELECT 
PRINT BOAT +:PRICE-PER-POUND 

LENGTH PRICE 

OVER PER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE POUND 
CAPE DORY TYPHOON SLOOP ig 1 +900 O06 $4;295 $2.26 


i 
| 
! DEFINE REPORT PROCEDURE 
i “ 
DEFINE PROCEDURE LOA-REPORT 
REPORT ON *.FILE 
SET REPORT-NAME="JIM‘S VERY OWN LISTING "“/"QF"/"INTERESTING SAILBOATS"/ 
"(BY LENGTH)" 
SET LINES-PAGE=35, COLUMNS-PAGE=72 
AT TOP OF LOA PRINT LOA ("LENGTH") 
PRINT TYPE» RIG; DISP; BEAM USING 29 »; PRICE 
AT BOTTOM OF LOA PRINT SKIP+ COL 32; "*** AVERAGE ***"; 
AVERAGE DISP;, AVERAGE BEAM, AVERAGE PRICE 
AT BOTTOM OF REPORT PRINT SKIP: "REPORT AVERAGES" + 
AVERAGE DISP; AVERAGE BEAM; AVERAGE PRICE 
AT BOTTOM OF PAGE PRINT SKIP: COL 20; 
""VANOTHER SERVICE OF QUERY ENTERPRISES""" 
END-REPORT 
END-PROCEDURE 
I 
! INVOKE REPORT (SUGGEST OUTPUT ON TI:) 
! 
:LOA-REPORT 
Enter FILE: TI: 
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JIM’S VERY OWN LISTING 


OF 
INTERESTING SAILBOATS 27-NOV-79 
(BY LENGTH) PAGE 1 
LENGTH MANUFACTURER MODEL RIG WEIGHT BEAM PRICE 
1s WINDPOWER IMPULSE SLOOP 650 7 $3,500 
¥** AVERAGE *##+% 650 07 $3,500 
19 CAPE DORY TYPHOON SLOOP 1+900 6 $4;295 
*#%# AVERAGE *#* 1 +900 OG $4,295 
21 VENTURE 2i SLOOP 1500 7 $2,823 
##% AVERAGE *#*+% 1,500 07 $2,823 
22 WENTURE 222 SLOOP 2:000 7 $3,564 
*##* AVERAGE *#* 27000 07 $3,564 
24] EASTWARD HO M/S 7 +000 9 $15,900 
ISLANDER BAHAMA SLOOP 4;:200 8 $6,500 
*** AVERAGE *#4# 3 +600 os $11,200 
25 IRWIN 23 SLOOP 5 +400 12 $10,950 
CAPE DORY 23 SLOOP 4+000 7 $8,995 
SALT 19 SLOOP 2 +600 7 $6,590 
¥*#* AVERAGE #*+* 4,000 oB $8,845 
26 “WESTERLY CENTAUR SLOOP 6-700 8 $15+245 
GRAHPIAN 26 SLOOP 3,600 8 $11,495 
AMERICAN 26-MS M/S 3 +500 8 $18,895 
TANZER 26 SLOOP 4;350 +} $1i1+750 
ALBIN 79 SLOOP 4+200 10 $17,900 
AMERICAN 26 SLOOP 4;:000 8 $9,895 
##% AVERAGE **+* 37058 08 $14,196 
27 HUNTER 27 SLOOP 6 +500 9 $14,999 
ALBIN VEGA SLOOP 3 +070 8 $18,600 
*#**% AVERAGE *#+* 3+785 08 $16,799 
28 CAPE DORY 28 SLOOP 9,000 9) $21,990 
SABRE 28 SLOOP 7 +400 9 $22 -000 
GRAMPIAN 28 SLOOP 6 800 10 $14,475 
TANZER 28 SLOOP 6 +800 10 $17+500 
"ANOTHER SERVICE OF QUERY ENTERPRISES" 
(continued on next page) 
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JIM’S VERY OWN LISTING 


OF 
INTERESTING SAILBOATS 27-NOV-79 
(BY LENGTH) PAGE 1 

LENGTH MANUFACTURER MODEL RIG WEIGHT BEAM PRICE 
ISLANDER 28 SLOOP 5;994 10 $15-908 
¥#**% AVERAGE ##+# 7+218 og $18+374 
29 NORTHERN 29 SLOOP 72250 9 $20,975 
#** AVERAGE *##+* 79250 09 $20;975 
30 IRWIN 30 SLOOP 10,000 10 $19;+950 
HUNTER 39 SLOOP 9.9500 10 $71,500 
GRAMPIAN 30 SLOOP 8,600 9 $17,775 
ISLANDER 30 SLOOP 8 +600 10 $70,990 
ALBIN BALLAD SLOOP 7s276 10 $27 +300 
##*% AVERAGE *¥#% 68;:795 o9 $21;+543 
a1 RYDER S. CROSS SLOOP 13,600 QO $32 +500 
BOMBAY CLIPPER Sloop 9-400 11 $273+950 
*#*#* AVERAGE ##+* 11:500 O35 $28 +225 
32 WRIGHT SEAWIND II SLOOP 14:+9900 ‘s) $34,480 
CHALLENGER 32 SLOOP 12,8006 11 $31;+835 
o’DAY 32 SLOOP i11:0900 rf) $29,500 
BAYFIELD 30/32 SLOOP 9-500 10 $32,875 
¥#** AVERAGE #*# 12;050 o5 $32,172 
33 GRAMPIAN 34 KETCH 12+000 10 $29,675 
#**% AVERAGE ##+# 12,000 10 $29,675 
34 GRAMPIAN 2-34 SLOOP ..11;+800 10 $29,675 
¥*#* AVERAGE *#* 11,800 10 $29,675 
35 CARIBBEAN 35 SLOOP 18:000 11 $37;850 
CHRIS-CRAF CARIBBEAN SLOOP i18:000 1i $37,850 
CHALLENGER 35 SLOOP 14;800 12 $39+215 
*¥** AVERAGE *#* 16,933 11 $38 +305 
36 I. TRADER 37 KETCH 18;+600 12 $39,500 
ISLANDER 36 SLOOP 13:+450 11 $31,730 
#**% AVERAGE *##% 16;025 11 $35,615 


"ANOTHER SERVICE OF QUERY ENTERPRISES" 
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JIM’S VERY OWN LISTING 


OF 


INTERESTING SAILBOATS 


(BY LENGTH) 


LENGTH MANUFACTURER MODEL RIG 
37 ALBERG 37 MK II KETCH 
IRWIN 37 MARK II KETCH 
NORTHERN 37 KETCH 

##* AVERAGE **+% 

39 LINDSEY 39 M/S 
#%¥% AYERAGE *#*% 
i CHALLENGER 4i KETCH 
GULFSTAR 41 KETCH 
ISLANDER FREEPORT KETCH 
COLUMBIA 4i SLOOP 

¥*% AVERAGE *#% 
42 OLYMPIC ADVENTURE KETCH 


¥*## AVERAGE *¥#+# 


REPORT AVERAGES 
"ANOTHER SERVICE OF QUERY ENTERPRISES" 


i 

|! INYOKE REPORT 
i 

:LOA-REPORT 
Enter FILE: Le: 


(SUGGEST OUTPUT ON LP:) 


! 
| RATTLE UPDATE 
l 


FIND YACHTS WITH BEAM=0 
CS records found] 


PRINT ALL 

LENGTH 

OVER 

MANUFACTURER MODEL RIG ALL 
METALMAST GALAXY SLOOP 32 
0’DAY 32 SLOOP 32 
RYDER S. CROSS SLOOP 31 
TA CHIAD FANTASIA LoGP 35 
WRIGHT SEAWIND II SLOOP 32 
SELECT FIRSTSPRINT 

LENGTH 

OVER 
MANUFACTURER MODEL RIG ALL 
METALMAST GALAKY SLOOP 32 
A-8 Acceptance Test 


WEIGHT 
20 +000 
20;000 
14;000 
18:000 
14,500 
14,500 
261700 
22,000 
22,000 
20,700 
221850 
24 +250 


2414250 


19,409 


WEIGHT 


9+500 
11,9000 
13+600 
23 +200 
14,900 


WEIGHT 


9500 


BEAM 


12 
E 
Lt 


ii 


13 


i3 


og 


BEAM 


oo 
oOo 
oOo 
OO 


00 


BEAM 


ore) 


PRICE 

$36,951 
$36 ;950 
$50,000 
$41,300 
$35 900 
$35 +900 
$51+22 

$41,350 
$54,970 
$48,490 
$49,009 
$80,500 


$80 +500 


$25 +388 


PRICE 


$29 +500 
$32 +500 


$34,480 


PRICE 


27-NOV-79 


PAGE 1 


(continued on next page) 


READY YACHTS MODIFY 

i 

! RESPOND WITH 47 (OR SOMETHING) 
i 


‘MODIFY BEAM 


Enter BEAM: 47 
PRINT TYPE+BEAM 
MANUFACTURER MODEL BEAM 


METALMAST GALAKY 47 


{ 
! RESPOND WITH 48 (OR SOMETHING) 
| 
MODIFY ALL BEAM 
Enter BEAM: 48 
| 


PRINT ALL BEAM 


BEAM 


ali 
ao 


48 
48 
48 
48 


! 
! RESPOND EACH TIME WITH 0 (PLEASE)? 


FOR CURRENT PRINT TYPE THEN MODIFY BEAM 


MANUFACTURER MODEL 
METALMAST GALAKY 
Enter BEAM: oOo 

o’DAY 32 
Enter BEAM: oO 

RYDER S. CROSS 

Enter BEAM: © 

TA CHIAO FANTASIA 
Enter BEAM: a 

WRIGHT SEAWIND II 
Enter BEAM: oO 
READY YACHTS READ 

PRINT ALL LENGTH 

OVER 

MANUFACTURER MODEL RIG ALL WEIGHT BEAM 
METALMAST GALAKY SLOOP 32 9+500 00 
O’DAY 32 SLOOP 32 11.000 a18) 
RYDER S. CROSS SLOOP 31 13,600 aT) 
TA CHIAD FANTASIA SLOOP 35 23 +200 oO 
WRIGHT SEAWIND II SLOOP 32 14,900 oo 


! CHECK MULTIPLE COLLECTIONS AND STATISTICAL FUNCTIONS 
| 


PRICE 


$29 +500 
$32 +5500 


$34,480 


(continued on next page) 
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FIND SMALLS IN YACHTS WITH LOA<24 AND PRICE NE 0 


C4 records found] 
| 


FIND BIGGIES IN YACHTS WITH LOA>40 AND PRICE NE © 


CS records found] 
| 


SHOW COLLECTIONS 

Collections 
BIGGIES (also CURRENT) 
SMALLS 


« 
* 


1 
PRINT AVERAGE DISP 


WEIGHT 


23+130 
1 


PRINT MAX DISP 
WEIGHT 
276 +700 


i 
PRINT AVERAGE PRICE OF BIGGIES+AVERAGE PRICE OF SMALLS 


PRICE PRICE 


$55 +307 $3,545 


| 

SORT SMALLS BY LOA;DISP 

SORT BIGGIES BY LOA+DISP 

SELECT FIRST SMALLS 

SELECT LAST BIGGIES 

PRINT SMALLS.BOAT>+SKIP+BIGGIES. BOAT 


LENGTH 

OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
WINDPOWER IMPULSE SLOOP i6 650 07 $3,500 
OLYMPIC ADVENTURE KETCH 42 24,250 13 $80 +500 


| 
! FINAL GALA TEST! 
! 


PRINT YACHTS WITH LOA EQ MAX LOA OF YACHTS 


LENGTH 

OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
OLYMPIC ADVENTURE KETCH 42 244250 is $80 500 
PEARSON 4ig KETCH 42 21 +000 


! TEST OF HIERARCHIES AND VIEW 
I 


DEFINE DOMAIN FAMILIES 
USING FAMILY-REC ON FAMILY.DATS 
DEFINE RECORD FAMILY-REC 


(continued on next page) 
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O1 FAMILY. 
O3 PARENTS. 
OG FATHER PIC X(10). 
OG MOTHER PIC X(10)., 
O03 NUMBER-KIDS PIC 99 EDIT-STRING IS 29, 


03 KIDS OCCURS 6 TO 10 TIMES DEPENDING ON NUMBER-KIDS. 


06 EACH-KID, 


O98 KID-NAME PIC (10) QUERY-NAME IS KID. 


OS AGE PIC 99 EDIT-STRING IS 29, 
5 
CRecord FAMILY-REC is 142 bytes long] 
| 
1! PERFORM A FEW NIFTY OPERATIONS ON FAMILIES 
| 
READY FAMILIES 
SHOW FIELDS FOR FAMILIES 
FAMILY 
PARENTS 
FATHER (CCharacter string] 
MOTHER CCharacter string] 
NUMBER-KIDS CNumber] 
KIDS (CList] 


EACH-KID 
KID-NAME (KID) [Character string] 
AGE PNombard] 


PRINT FAMILIES 


NUMBER KID 
FATHER MOTHER KIDS NAME AGE 
JIM ANN 2 URSULA 7 
RALPH 3 
JIM LOUISE rs) ANNE ai 
JIM 29 
ELLEN 26 
DAVID 24 
ROBERT iG 
JOHN JULIE 2 ANN 29g 
JEAN 26 
JOHN ELLEN 1 CHRISTOPHR 0 
ARNIE ANNE 2 SCOTT 2 
BRIAN 0 
SHERMAN SARAH 1 DAVID Q 
TOM ANNE 2 PATRICK 4 
SUZTE 6 
BASIL MERIDETH 6 BEAU 2 
BROOKS 26 
ROBIN 4 
JAY 22 
WREN 17? 
JILL 20 
ROB DIDI 0 
JEROME RUTH 4 ERIC 32 
CIssy 24 
NANCY 22 
MICHAEL 20 
TOM BETTY 2 MARTHA 30 
TOM at 
GEORGE LOIS 3 JEFF 23 
FRED 26 
LAURA 21 
HAROLD SARAH 3 CHARLIE ai 
HAROLD 35 
SARAH 27 


(continued on next page) 
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A-12 


FIND FAMILIES WITH KIDS WITH AGE?25 


C7? records found] 
PRINT ALL SKIP+ PARENT 


S+ ALL KIDS SORTED BY AGE 


KID 
NAME 


ROBERT 
DAVID 
ELLEN 
JIM 
ANNE 


JEAN 
ANN 


WREN 
JILL 
JAY 
ROBIN 
BROOKS 
BEAU 


MICHAEL 
NANCY 
Cissy 
ERIC 


TOM 
MARTHA 


LAURA 
JEFF 


FRED 


FATHER MOTHER 
JIM LOUISE 
JOHN JULIE 
BASIL MERIDETH 
JEROME RUTH 

TOM BETTY 
GEORGE LOIS 
HAROLD SARAH 
FINISH 


! DEFINE A VIEW OT THE DOMAIN YACHTS 


DEFINE DOMAIN KETCHES 
OF YACHTS BY 


O1 KETCH OCCURS FOR YACHTS WITH RIG EQ 


03 TYPE FROM YACHTS 
03 LOA FROM YACHTS, 
03 PRICE FROM YACHT 

i 

! 

!'SHOW OFF KETCHES 

! 

READY KETCHES 

PRINT KETCHES 


MANUFACTURER MODEL 


ALBERG 37 MK II 
CHALLENGER 41 
FISHER 30 
FISHER 37 
GRAMPIAN 34 
GULFSTAR 4i 
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SARAH 
CHARLIE 
HAROLD 


+ 


S;. 


AGE 


16 
24 
26 
29 
31 


26 
29 


17 
20 
Lz 
24 
26 
28 


20 


2? 


— in 
24 


32 


LENGTH 


OVER 


ALL 


37 
41 
30 
37 
33 
41 


PRICE 
$36,951 
$51+228 


$29,675 
$41 +350 


"KETCH",. 


(continued on next page) 


I. TRADER 37 36 $39 +500 


IRWIN 37 MARK ITI 3? $236 +950 
ISLANDER FREEPORT 41 $54 ;5970 
NORTHERN 37 ae $50 ;000 
OLYMPIC ADVENTURE 42 $80 +500 
PEARSON 365 36 

PEARSON 419 42 

FINISH 


I 
! DEFINE A DOMAIN AND FILE OF SAILBOAT OWNERS 
i 
DEFINE DOMAIN OWNERS 
USING OWNER-RECORD ON OWNER.DATS5 
DEFINE RECORD OWNER-RECORD 
Ol OWNER. 
O3 NAME PIC K(10) QUERY-HEADER IS "OWNER"'/ "NAME" 
EDIT-STRING IS X(3). 
O3 BOAT-NAME PIC X(17) QUERY-HEADER IS "BOAT NAME", 
O3 TYPE. 
OG BUILDER PIC XK(10),. 
OG MODEL PIC K(10). 
3 
[Record OWNER-RECORD is 47 bytes long] 
DEFINE DOMAIN OWNERS-SEQUENTIAL USING OWNER-RECORD ON OWNER,.SEQ5 
DEFINE FILE FOR OWNERS RKREY=TYPE( DUP) + SUPERSEDE 
READY OWNERS WRITE 
READY OGWNERS-SEQUENTIAL . 
FOR OWNERS-SEQUENTIAL STORE OWNERS USING OWNER=OWNER 
FINISH OWNERS-SEQUENTIAL 
i 
PRINT OUT THE OWNERS FILE 


! 
| 
PRINT OWNERS 


OWNER 

NAME BOAT NAME BUILDER MODEL 
SHERM MILLENNIUM FALCON ALBERG 30 

STEVE DELIVERANCE ALBIN VEGA 
HUGH IMPULSE ALBIN VEGA 

JIM EGRET ca&C CORVETTE 
ANN EGRET C&C CORVETTE 
BOB FIESTA CAL 28 

JIM REGRET CHEAP DINK 
NETL JARGES PRIDE CROCKER 33 

GERAR KESTREL ERICSON 39 

ARNE CHIMERA HINKLEY BERMUDA 40 
JIM POTEMKIN ISLANDER BAHAMNA 
ANN POTEMKIN ISLANDER BAHAMA 
STEVE POTEMKIN ISLANDER BAHAMA 
HARVE MANANA ISLANDER BAHAMA 
TOM LONE TRAVELLER PEARSON 10M 

DICK PURSUIT PEARSON 26 

CHRIS VANITY PEARSON ARTEL 
JOHN STRIDER RHODES SWIFTSURE 
FINISH 


I 
{ DEFINE THE MIGHT+ MULTIPLE FILE VIEW OF YACHTS AND OWNERS 
! 
DEFINE DOMAIN SAILBOATS 
OF YACHTS: OWNERS BY 
01 SAILBOAT OCCURS FOR YACHTS. 


Acceptance Test A-13 


03 BOAT FROM YACHTS. 
03 SKIPPERS OCCURS FOR OWNERS WITH TYPE EQ BOAT.TYPE. 
OS NAME FROM OWNERS, 


5 
\ 
| EXERCISE SAILBOATS A LITTLE 
i 
READY SAILBOATS 
SHOW FIELDS 
SAILBOATS 
SAILBOAT 
BOAT 
TYPE CIindexed field] 
MANUFACTURER (BUILDER) (Character strings indexed Keyl 
MODEL [Character string: indexed Ker] 
SPECIFICATIONS (SPECS) 
RIG [Character string] 
LENGTH-QVER-ALL (LOA) [CCharacter string] 
DISPLACEMENT (DISP) (CNumber] 
BEAM CNumber] 
PRICE CNumber] 
SKIPPERS CList] 
NAME [Character string] 


PRINT FIRST 3 SAILBOATS 


LENGTH 

OVER OWNER 
MANUFACTURER MODEL RIG ALL WETGHT BEAM PRICE NAME 
ALBERG 37 MK II KETCH 37 202000 iz $36 +951 
ALBIN 79 SLOOP 26 4+200 10 $17;900 
ALBIN BALLAD SLOOP 30 71276 10 $27 +500 
ALBIN VEGA SLOOP 26 37070 08 $18;600 STEVE 
AMERICAN 26 SLOOP 26 4.000 08 $9;+895 


FIND SAILBOATS WITH ANY SKIPPERS 
[G records found] 


PRINT ALL 
LENGTH 
OVER OWNER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE NAME 
ALBIN VEGA SLOOP 27 3 +070 o8 $18,600 STEVE 
HUGH 
C&c CORVETTE SLOOP 31 8;:650 o9 JIM 
ANN 
ISLANDER BAHAMA SLOOP 24 4,200 og $6;500 JIM 
ANN 
STEVE 
HARVE 
PEARSON 10M LOOP 33 12,441 il TOM 
PEARSON 26 SLOOP 26 27400 08 DICK 
RHODES SWIFTSURE SLOOP 33 14,000 i0 JOHN 


i CHECK OUT TABLES 
! 
DEFINE TABLE RIG-TABLE 
"SLOOP" : "ONE MAST": 
"KETCH" : "TWO MASTS, BIG ONE IN FRONT"; 
"YAwWL" : "SIMILAR TO KETCH", 
"™/S" : "SAILS AND BIG MOTOR", 
ELSE "SOMETHING ELSE" 
(continued on next page) 
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END-TABLE 

I 

READY YACHTS 

FIND YACHTS WITH RIG IN RIG-TABLE 
[i098 records found] 


PRINT ALL TYPEs RIG+ RIG VIA RIG-TABLE USING K(30) 
MANUFACTURER MODEL RIG RIG 

ALBERG 37 MK II KETCH TWO MASTS+s BIG ONE IN FRONT 
ALBIN 79 SLOOP ONE MAST 

ALBIN BALLAD SLOOP ONE MAST 

ALBIN VEGA SLOOP ONE MAST 

AMERICAN 26 SLOOP ONE MAST 

BAYFIELD 30/32 SLOOP ONE MAST 

BLOCK I. 40 SLOOP ONE MAST 

BOMBAY CLIPPER SLOOP ONE MAST 

BUCCANEER 270 SLOOP ONE MAST 

BUCCANEER 320 SLOOP ONE MAST 

ca&C CORVETTE SLOOP ONE MAST 

CABOT 36 SLOOP ONE MAST 

CAL 2-27 SLOOP ONE MAST 

CAL 2-34 SLOOP ONE MAST 

CAL 29 SLOOP ONE MAST 

CAL 3-30 SLOOP ONE MAST 

CAL 35 SLOOP ONE MAST 

CAPE DORY 20 SLOOP ONE MAST 

CAPE DORY 28 SLOOP ONE MAST 

CAPE DORY TYPHOON SLOOP ONE MAST 

CAPITAL NEWPORT SLOOP ONE MAST 

CARIBBEAN 35 SLOOP ONE MAST 

CHALLENGER 32 SLOOP ONE MAST 

CHALLENGER 35 SLOOP ONE MAST 

CHALLENGER 41 KETCH THO MASTS: BIG ONE IN FRONT 
CHRIS-CRAF CARIBBEAN SLOOP ONE MAST 

COLUMBIA 39 SLOOP ONE MAST 

COLUMBIA 41 SLOOP ONE MAST 

COLUMBIA PAYNE 9.6 SLOOP ONE MAST 

DOUGLAS 32 SLOOP ONE MAST 

DOWN EAST 32 SLOOP ONE MAST 

DOWN EAST 38 SLOOP ONE MAST 

DUFOUR 20 SLOOP ONE MAST 

ENCHILADA 20 SLOOP ONE MAST 

ENDEAVOR 32 SLOOP ONE MAST 

ERICSON 23/SPECTIAL SLOOP ONE MAST 

ERICSON CRUISING/3 SLOOP ONE MAST 

FISHER 30 KETCH TWO MASTS: BIG ONE IN FRONT 
FISHER 37 KETCH TWO MASTS; BIG ONE IN FRONT 
GRAMPIAN 2-34 SLOOP ONE MAST 

GRAMPIAN 26 SLOOP ONE MAST 

GRAMPIAN 28 SLOOP ONE MAST 

GRAMPIAN 30 SLOOP ONE MAST 

GRAMPIAN 34 KETCH TWO MASTS; BIG ONE IN FRONT 
GRAMPIAN 4i KETCH TWO MASTS: BIG ONE IN FRONT 
HUNTER 2? SLOOP ONE MAST 

HUNTER 30 SLOOP ONE MAST 

I, TRADER 37 KETCH TWO MASTS: BIG ONE IN FRONT 
IRWIN 20 SLOOP ONE MAST 

IRWIN 30 SLOOP ONE MAST 

IRWIN 37 MARK II KETCH TWO MASTS; BIG ONE IN FRONT 
IRWIN HALF TON SLOOP ONE MAST 

ISLANDER 28 SLOOP ONE MAST 

ISLANDER 30 SLOOP ONE MAST 

ISLANDER 36 SLOOP ONE MAST 


Acceptance Test 
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ISLANDER BAHAMA 
ISLANDER FREEPORT 
MARTEHOLD 32 
METALMAST GALAKY 
NAUTOR SHAN 41 
NEWPORT 278 
NEWPORT 30 II 
NEWPORT 41 5 
NICHOLSON 33 
NORTHERN 2g 
NORTHERN 37 
0’DAY 27 
O’DAY 32 
OLYMPIC ADVENTURE 
ONTARIO 32 
ONTARIO VIKING 
PACESHIP 26 
PEARSON 10M 
PEARSON 26 
PEARSON 26h 
PEARSON 28 
PEARSON 30 
PEARSON 35 
PEARSON 36 
PEARSON 365 
PEARSON 39 
PEARSON 4i9g 
RANGER 26 
RANGER 28 
RANGER 29 
RANGER 33 
RHODES SWIFTSURE 
ROBERTS 29 
ROBERTS 36 
RYDER S. CROSS 
SZ 8M AFT 
S2 8M MID 
SABRE 28 
SALT 19 
SAN JUAN 21 
SAN JUAN 26 
SCAMPI 30 
SOLNA CORP SCAMPI 
TA CHIAD FANTASIA 
TANZER 26 
TANZER 28 
VENTURE Zl 
VENTURE 222 
WESTERLY CENTAUR 
WESTSAIL 32 
WINDPOWER IMPULSE 
WRIGHT SEAWIND Ii 
SHOW TABLES 
Tabies ioaded: 

RIG-TABLE 
Tables: 

RIG-TABLE 
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SLOOP 
KETCH 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
KETCH 
SLOOP 
SLOOP 
KETCH 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
KETCH 
SLOOP 
KETCH 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 


ONE 
TWO 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
TWO 
ONE 
ONE 
TWO 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
TWO 
ONE 
THO 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 
ONE 


MAST 
MASTS; BIG ONE IN FRONT 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MASTS,» BIG ONE IN FRONT 
MAST 
MAST 
MASTS: BIG ONE IN FRONT 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MASTS: BIG ONE IN FRONT 
MAST 
MASTS+ BIG ONE IN FRONT 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 
MAST 


y 
! DECLAR 
i 


DECLARE 


i 
PRINT TY 


MANUFACT 


ALBERG 
ALBIN 
ALBIN 
ALBIN 
AMERICAN 
AMERICAN 
BAYFIELD 
BLOCK I. 
BOMBAY 
BUCCANEE 


RELEAS 


DEFINEP 
DEFINEP 
DEF INEP 
DEF INEP 
DEF INEP 
DEF INEP 
DEF INEP 
DEFINEP 
I 


! END OF 
i 


mt 
Ak 


EA OBAL VARTABLE TO SIMPLIFY TABLE LOOK UP 


RIG-DESCRIPTION COMPUTED BY RIG VIA RIG-TABLE 
EDIT-STRING IS XK(30), 


PEs RIG-DESCRIPTION OF FIRST 10 YACHTS 
RIG 
URER MODEL DESCRIPTION 
37 MK II TWO MASTS,» BIG ONE IN FRONT 
79 ONE MAST 
BALLAD ONE MAST 
VEGA ONE MAST 
26 ONE MAST 
26-M5 SOMETHING ELSE 
30/32 ONE MAST 
Ao ONE MAST 
CLIPPER ONE MAST 
R 270 ONE MAST 
E TABLE AND GLOBAL COMPUTED BY VARIABLE FROM MEMORY 
RIG-TABLE 
IND GESTURE, MAKE ALL OF THE EXAMPLES SHARABLE 


RIG-TABLE 2;UIC+C#+#1;>RE 
FAMILIES 2;+UIC+C#¥+#1]>-R 
FAMILY-REC 2;+UIC+0C#+#1];-RE 
KETCHES 2;-UIC,C#+#]+R 


OLIKICSSC 2; UIC ;fe;2] =) 


WA Wb FRO PE FIN 


OWNER-RECORD 2;UIC+;C#+s#1+RE 
LOA-REPORT 2;UICsC#+*#1;+RE 
SAILBOATS 2-UIC+C#+#1 +R 


INSTALLATION TEST 
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DATATRIEVE 
Installation Guide 
AA-H169A-TC 


Reader’s Comments 


Note: This form is for document comments only. Digital will use comments submitted on this form at 
the company’s discretion. If you require a written reply and are eligible to receive one under 
Software Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well-organized? Please make suggestions for 
improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


[] Assembly language programmer 
(] Higher-level language programmer 
[J] Occasional programmer (experienced) 
[] User with little programming experience 
[] Student programmer 
[] Other (please specify) 
Name 2 ‘Date 
Organization 
Street 
Zip Code 
or 


City. SCS tat“ 
: Country 
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